Fixes #1678

Summary of Changes

This pull request introduces a new module for managing license clarity thresholds:

About the policies.yml Structure for License Clarity Thresholds
The policies.yml file is a YAML configuration used to define various compliance policies for ScanCode.io and related tools. With these changes, a new section called license_clarity_thresholds is introduced specifically for clarity score compliance.

Example policies.yml for clarity thresholds:

license_clarity_thresholds:
  80: ok        # Scores 80 and above are 'ok'
  50: warning   # Scores 50 to 79 are 'warning'
  # Scores below 50 are automatically considered 'error'

• Validation of threshold policy structure:

  • Keys must be integers
  • Values must be one of: ok, warning, error
  • No duplicate thresholds
  • Thresholds must be in strictly descending order

• Evaluation logic for mapping clarity scores to compliance alerts (ok, warning, error)

• Comprehensive test suite covering:

  • Valid and invalid YAML configurations
  • Duplicate and unordered thresholds
  • Single and multiple thresholds

Note: This module is self-contained and not yet integrated into the main compliance or project logic. It is intended for review and further development.

Future Work

• Integration with summary generation to include clarity compliance alerts in outputs
• UI and reporting integration to show clarity compliance results alongside existing license compliance alerts
• Documentation updates to guide users on configuring and using license clarity thresholds in policies.yml